home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / btrieve / btrsim.exe / BSIM.HLP < prev    next >
Text File  |  1990-06-16  |  5KB  |  163 lines
  1.  
  2. GENERAL HELP
  3. 22
  4. This program allows you to execute most of the Btrieve operations directly
  5. without having to write your own program.
  6.  
  7. This can be very helpful when you are just learning Btrieve as well as
  8. when you want to analyze how Btrieve operations affect the different
  9. parameters byte by byte.
  10.  
  11. Also, it is very useful for trouble-shooting problems in your application
  12. program - i.e, if the same sequence of Btrieve calls can reproduce your
  13. problem, then you know that it is not a bug in your application.
  14.  
  15. Major features of this program.
  16. - Up to 20 files open and accessible at once. Detailed info on each file.
  17. - Viewing / editing facility for Data and Key Buffers.
  18. - Can access, view, edit records up to 32K bytes long.
  19. - English status and error messages.
  20. - Use to easily Create any kind of Btrieve file.
  21. - Get statistics on files.
  22. - Create and Drop supplemental indices.
  23. - Viewing of Position Block.
  24. - Shell to Dos feature.
  25. - Help menu.
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43. DATA/KEY BUFFERS
  44. 17
  45. - When you choose Data or Key Buffer, you can see or edit all values
  46.   stored in the buffer. All displayable characters are shown in ascii,
  47.   while all values are displayed in hex below the ascii line.
  48.  
  49. - You can move right or left using arrows, tab, shift-tab, home, or end.
  50.   You can use the up and down arrows to move to the ascii or hex lines.
  51.  
  52. - When you change an ascii character, the hex values change. When you
  53.   change a hex value, the ascii value changes.
  54.  
  55. - If you position the buffer at, e.g. offset 300-380, hit return, and
  56.   do a get next, the next record will be displayed at that offset. This
  57.   makes it easy to scroll and view a certain area in each record.
  58.  
  59. - Use Alt-D to toggle the Display Hex mode. Use this if you only want to
  60.   look at the displayable characters in the buffer.
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71. POSITION BLOCKS
  72. 22
  73. This program provides great flexibility for doing multi-file simulations.
  74. You can have up to 20 position blocks allocated at once and each position
  75. block can use a different amount of memory. This is very useful if you
  76. need to access files with very large record sizes.
  77.  
  78. - Pos Blk 1 is already allocated for you.
  79.  
  80. - Go to Change position block screen to allocate or deallocate pos blks.
  81.   This just grabs memory off the heap to store data/key buffers and
  82.   various other  internal structures. User enters amount of heap space
  83.   to allocate for each position block. This allows you to access 1 file
  84.   with very large records and several other files with small records.
  85.  
  86. - Information regarding each position block and any file opened to that
  87.   block is on the screen, including filename, open mode, last operation
  88.   and status on that position block and maximum record length. This is
  89.   useful in keeping track of where you are in a complex multi-file test.
  90.  
  91. - If you shell out to Dos from the main menu, your position blocks are
  92.   still allocated and intact when you return.
  93.  
  94.  
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111. SPECIAL OPERATIONS
  112. 22
  113. Bsim allows you to perform many of the difficult Btrieve operations
  114. by, for example, prompting you for information to put in the data buffer
  115. for the CREATE operation. It also interprets information returned from
  116. Btrieve in, e.g. the STATUS operation. Here is a list of the operations
  117. which are are handled differently:
  118.  
  119.   - Create:  Put data in buffer 1st, then do the actual Create operation
  120.   - Create Supplemental Index:
  121.              Similar to create, just with key info
  122.   - Version: Give version of Btrieve loaded
  123.   - Stat:    Displays statistics from Stat operation in easy-to-read format.
  124.   - Extended Gets  {not implemented yet}
  125.              Will allow user to simulate filtering operations
  126.   - Extended Steps {not implemented yet}
  127.              Will allow user to insert a load file into their Btrieve file.
  128.  
  129. Note: As with all other operations, the Btrieve parameters are changed
  130.       as they would be in your program. You can see how Btrieve actually
  131.       modifies these parameters. This can be very useful when you are first
  132.       learning how to do, e.g. a Create operation. Enter the information
  133.       through prompts and then look at how the information is stored
  134.       in the data buffer.
  135.  
  136.  
  137.  
  138.  
  139.  
  140.  
  141.  
  142.  
  143.  
  144. SUGGESTIONS / BUG REPORTS
  145. 17
  146.  
  147. Please direct all enhancement suggestions or bug reports to
  148.  
  149. David Garrison @ Novell  (DPD)
  150.  
  151.  
  152. Again, please do not distribute this program externally to Novell.
  153. Thanks for your cooperation.
  154.  
  155.  
  156.  
  157.  
  158.  
  159.  
  160.  
  161.  
  162.  
  163.